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New Chips for the IIgs 


Apple is now shipping version 2 of the IIgs system ROM, and you 
are supposed to be able to get a free upgrade at your dealer. If 
your IIgs has the color fringe problem, they will also change a 
graphics chip. The new ROM fixes a lot of bugs in the various 
ROM-based tools, and adds some new features. One new feature I 
like is a new monitor command (“#") which installs the monitor as 
a desk accessory. Once done, the monitor is always available in 
a few keystrokes, and you can easily return to exactly the point 
from which you called it. 


Naturally, the new ROM makes the "S$" command in the S-C Macro 
Assembler non-functional again. I will have to dig into the new 
code and see why, and fix it again. Unfortunately, as of the day 
I am typing this, I have not actually been able to upgrade MY 
IIgs. Mine is a prototype, and I have the “airplane” ROM board 
where Apple's single ROM chip is supposed to be. Maybe they will 
send me the appropriate upgrade soon, or maybe I'll be able to 
make a copy into 27256 EPROMs. 


New Apple Accessories Coming Soon 


You have read about Applied Engineering's PC Transporter in A+ 
Magazine. But how about the ZIP CHIP from ZIP Technology? Or 
the GSX IIgs Accelerator from MDIdeas? Or the Memory Saver from 
Checkmate? ZIP CHIP is one of several new accelerators for 
pre-IIgs machines which are each a single chip that replace the 
6502 or 65C02. The replacement contains the equivalent of a 4 
MHz 65C0O2 with its own clock circuit and some super fast cache 
RAM; it is supposed to be inexpensive, compatible with 
everything, and make it all happen 3 or 4 times faster. GSX is a 
more traditional accelerator, fitting in any IIgs slot (1-7), and 
having a faster 65816 and RAM than is on the motherboard. It can 
run at 5.6 MHz and can include as much as 1 Mbyte of fast static 
RAM. Memory Saver turns an ordinary Apple RAM card or AE gsRAM 
card into a battery-backed up RAM, much like RamCharger does for 
RamFactor. All available soon, they say.... 


Using Double Lo-Res Graphics.............-BOb Sander-Ceder lot! 


That's right, low resolution, not high. Apple never talks 
about it, but the //e, //c, and IIgs all have a double low 
resolution mode, displaying either 40 or 48 lines of 80 pixels, 
in 16 colors. I know it is not in fashion, but lo-res still 
has some advantages over hi-res. For one, it is faster; for 
another, it takes less memory. 


Subroutines to plot in lo-res graphics are included in the 
monitor firmware, and statements are included in both Integer 
BASIC and Applesoft. I have written some subroutines which 
provide all the same functions in double lo-res mode, and also 
added BOX and LINE subroutines. Since all //c and IIgs 
Machines can execute the 65C02 extensions, and since all 
enhanced //e's also can, I decided to include some 65C02 
instructions. They make the code a lot easier to write. I 
used the PHY, PLY, and BRA opcodes; I also used the INC opcode 
with no operand to increment the A-register. If you have an 
old unenhanced //e, you will have to re-write the code where 
these instructions occur. 


Turning Double Lo-Res On and Off: 


The same soft switch that changes normal hi-res into double 
hi-res does the trick for lo-res also. Reading or writing 
SCO5E will double the resolution, and $CO5F will put it back to 
normal. You also have to be in 80-column mode. 


In 40-column mode with the “double” switch turned on you get a 
weird result: You still have only 40 pixels per line, and only 
four colors rather than 16. Furthermore, somehow which color 
is displayed for a particular pixel value depends on which 
column you are in! This is not a particularly useful mode, uo 
I am not going to talk about it any more. Let's just stay in 
80-column mode when we want to use double lo-res. 


Applesoft's “GR" statement turns on the Lo-Res mode, clears the 
top 40 graphics lines, and sets the text window to the bottom 
four text lines. My subroutine “DLR"“, in lines 1700-1780, only 
turns on the double lo-res mode. I did not include clearing 
the graphics screen, or setting the text window. I included a 
separate subroutine “CLRTOP” for clearing the graphics screen, 
and “SETTOP“ for setting the entire graphics screen to whatever 
the current color is (lines 2220-2250). 


Lines 1640-1670 turn the double lo-res graphics back off, 
resetting to text mode. You could add a line here to clear the 
text screen and restore a full text window, like the Applesoft 
TEXT statement, if you wish. 


Setting the Plotting Color: 


The monitor firmware contains two entry points that my code 
uses: SETCOL (S$F864) and PLOT ($F800). SETCOL uses the 
low-order four bits in the A-register to store a color value at 
COLOR ($30). This value is formed by stuffing the 4-bit color 
value in both the left and right nybbles of COLOR. 
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S-C Macro Assembler Version 2.0......DOS $100, ProDOS $100, both for $120 
Version 2.0 DOS Upgrade Kit for 1.0/1.1/1.2 ownerS......ccccvsccccseeeS20 
ProDOS Upgrade Kit for Version 2.0 DOS ownerS...cccccccccccccscceccsces 930 
Source Code of S-C Macro 2.0 (DOS or ProDOS)........each, additional $100 
S-C DisAssembler (ProDOS only)...without source code $30, with source $50 
RAK-Ware DISASM (DOS only).......without source code $30, with source $50 
PrOVIEW (PLODOS. ONLY) o:56.6:seisiS640.6 WSC Win ww 66 Swe BTS CCEA Ho 8 iOS we See we ZU 
Full Screen Editor for S-C Macro (with complete source code) ..........$49 
S-C Cross Reference Utility......without source code $20, with source $50 
S-C Word Processor (with complete source Code) ...cccccccccccccccseceee 900 
DP18 and DPFP, including complete source and object code.....seeeeeee $50 
ES-CAPE (Extended S-C Applesoft Program Editor)......cee. 

Including Version 2.0 With Source Code..........$50 
ES-CAPE Version 2.0 and Source Code Update (for Registered Owners)....$30 
Bag of Tricks 2 (Quality Software) ....ccccccccccssccccvccecee (949.95) $45 
MacASM -- Macro Assembler for MacIntosh (Mainstay)......---($150.00) $50 
S-C Documentor (complete commented source code of Applesoft ROMS).....$50 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 

(Available: 6800/1/2, 6301, 6805, 6809, 68000, Z-80, 2-8, 8048, 
8051, 8085, 1802/4/5, PDP-11l, GI1650/70, others) 

Beagle Bros. Applesoft Compiler (ProDOS only) ......ceeceeeee ($74.95) $65 


AAL Quarterly DisSkS.....ccccccccccvccccesese ach $15, or any four for $45 
Each disk contains the source code from three issues of AAL: 
Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


Diskettes (with hub ringS) .....c.ccccccccvcceccceesee package Of 25 for $15 
Vinyl disk pages, 6"x8.5", hold two disks each........c.eeeeeeee10 for $6 
Diskette Mailing Protectors (hold 1 or 2 disks).............40 cents each 

(Cardboard folders designed to fit 6°X9" Envelopes.) or $25 per 100 
Envelopes for Diskette Mailers... cccccccccccccccsesccceeee 6 Cents each 


65802 Microprocessor (Western DeSign CeEMNter) ....cccccccrsecreccccsece $25 
quikLoader EPROM System (SCRG) @eeoeseeeeseeee7e7eVeesteeeeeseeeeeeesteseoee 8 @ ($179) $170 
PROmGRAMER (SCRG) eeeoeeoesesve70fkreeeeeeeeesweespteeseeensteee#estsoeeeweseeeseeeses#e ($149.50) $140 


Minuteman 250 Uninterruptible Power Supply....cccsccccscsccceee ($399) $320. 


"Apple //gs Technical Reference", FiSChEr...ccccccccccceceee ($19.95) $19 
"65816/65802 Assembly Language Programming", Fischer........($21.95) $20 
"Programming the 65816", EyeS..ccccccccccccccccccccccccsccese(9eee99) $21 
"Apple //e Reference Manual", Apple Computer.....cececcereee ($24.95) $23 
"Apple //c Reference Manual", Apple Computer......ccecseceee ($24.95) $23 
“ProDOS-8 Technical Reference Manual", Apple Computer.......($29.95) $27 
“ProDOS-16 Technical Reference Manual", Apple Computer......($29.95) $27 
“Apple IIgs Firmware Reference", Apple Computer......e.cee+e.($24.95) $23 
“ProDOS Inside and Out", Doms & WeiShaar....ccccccsceccccceee (916.95) $16 
“DOStalk Scrapbook", Weishaar & KerSey....cccccsecseccccceee(9l4.95) $14 
“Beneath Apple ProDOS", Worth & Lechne€r....ccccsccccccssceee ($919.95) $18 
“Beneath Apple DOS", Worth & LECHNEr..cccccccsccccccecceccee (919.95) $18 
"Inside the Apple //c%, Little... cccccccccccscccccscccsecsee (919.95) $18 
“Inside the Apple //e", Tid CEC i oo wes hae Sale Pe wee we ees (OL Go) $18 
“Understanding the Apple //e“, Sather... c.cccccccccsecccecee (924.95) $23 
“Understanding the Apple II", Sather....cccccrccccccsecscesee( 922.99) $21 
"Apple II+/IIe Troubleshooting & Repair Guide", Brenner.....($19.95) $18 
"Apple ][ Circuit Description", Gayler....cccccsccsseccccsces (922.99) $21 
"Assem. Language for Applesoft Programmers", Finley & Myers.($18.95) $18 
“Now That You Know Apple Assembly Language...", Gilder......($19.95) $18 
“Enhancing Your Apple II, vol. 1", Lancaster....ccecccecveee (915.95) $15 
“Enhancing Your Apple II, vol. 2", Lancaster....cccceccvccee($Sl7.95) $17 
“Assembly Cookbook for the Apple II/IIe", Lancaster.........($21.95) $20 
"Microcomputer Graphics8", MYErS.ccccccccccccsccccccccccscces (914.95) $14 
“Assembly Lines -- the Book", Wagner. ..ccccccccccscccccceseee (919.95) $18 
"AppleVisions", Bishop & GrOSSDEFGer..cecsccseccccsccccesces (939-95) $36 


* On these items add $2.00 for the first item and 
$.75 for each additional item for US shipping. 
+ Inquire for shipping cost. 
Foreign customers inquire for postage needed. 
Texas residents please add 7.25 % sales tax to all orders. 


#** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
kar (214) 324-2050 nat 
*** Master Card, VISA, Discover and American Express *** 
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Plotting Single Points: 


The monitor PLOT subroutine at S$F800 will plot a single point 
on the normal Lo-Res screen. It expects the Y-coordinate in 
the A-register, and the X-coordinate in the Y-register. I set 
up my DPLOT subroutine the same way, but the X-coordinate can 
be any value from 0 to 79 instead of just 0 to 39. Double 
Lo-Res works the same way 80-column text does: columns 0, 2, 
4, «+78 are stored in AuxRAM, and columns l, 3, 5, ...79 are 
stored in MainRAM. Since the softswitches 80COL and 80STORE 
are both in 80-mode, the PAGE2 switch controls whether text 
screen addresses reference AUX or MAIN memory. 


My DPLOT subroutine is in lines 1800-1960. I look at the least 
significant bit of the X-coordinate to determine whether the 
pixel will be in MAIN or AUX memory. If it will be in AUX 
memory, then I flip to AUX memory before calling PLOT. I also 
divide the X-coordinate by two, so that PLOT will put it in the 
right position in the selected bank. After PLOT has painted 
the pixel, I make sure I am back in MAIN memory at line 1930. 

I made my DPLOT subroutine save and restore the A- and 
Y-registers, even though the monitor PLOT subroutine did not. 
This made some of the other subroutines cleaner. 


Lines 1800-1820 are a special entry to DPLOT, and plot the 
point whose coordinates are stored in the Xl and Yl variables. 


Horizontal and Vertical Lines: 


Both Integer BASIC and Applesoft include the HLIN and VLIN 
statements for drawing horizontal and vertical lines. These 
are faster to draw and easier to implement than the more 
general line drawing algorithm included in Hi-Res graphics. 
Lines 1980-2080 are my double Lo-Res HLIN and VLIN subroutines. 
Like the ones in the monitor firmware, the coordinates for the 
beginning of the line must be in the A- and Y-registers; the 
other end of the line is specified by the value in X2 for HLIN, 
or in Y¥2 for VLIN. 


My version of HLIN is slower than it ought to be, because I 
used the monitor PLOT subroutine inside DPLOT. This causes 
GBASCALC to be called for every pixel, even though it does not 
need to be called after the first pixel. I could write a 
second version of DPLOT which calls PLOT1 in the firmware, 
bypassing the GBASCALC call, but I decide not to bother. 


Drawing Boxes: 


Lines 2100-2200 will draw a rectangle (box) of the currently 
selected color. The A- and Y-registers specify the lower-right 
corner of the rectangle; the variables Xl and Yl specify the 
upper-left corner. 


To make it easier to program BOX-calls, I defined three macros: 
FROM, BOX, and BOX.TO. “>FROM valueX,valueY" will assemble a 
call to SET.X1.¥l1 in lines 3160-3200. This subroutine makes 
sure neither coordinate is beyond the screen and stores them in 
Xl and Yl. For example: 
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GSRAM Plus™ 


Rnnanbes the 16K cards for the I+ and 
the 64K cards for the Ie? At the time, that 
much memory seemed like a low: But when 
the owners of these memory cards came to 
us for more Memory, many had to throw 
away their smaller Apple memory cards or ty 
to sell them. Most of our customers told. us 
that had they known about Applied Engi- 
neering's Langer memory cards when they 
bought their Apple, they would have pur 
Chased them at the same time. 

GSRAM and GSRAM Plus are availible now, 
alowing up to 8 MEG of memory expansion. 
That's 8 times the memory capacity of 
Apple's card and just look at the benefits that 
only GSRAM and GSRAM Plus have over 
Apple's card: 

© Lower cost 

e fas 6 RAM banks (Apple's card has 4) 

e Has memory expansion port 

e Has ROM expansion porn 

e No configuration blocks to set 

e No soldered in RAM chips 

e Expandiible to 8 MEG 

e Expands AppleWorks intemal limits 

e Built-in 1 fi-Res self- diagnostic software 

e 5 year hassle free waranty (Apple has a 90 
day waranty) 

e Made in USA 


GsRAM for More 

AppleWorks Power 

Only GSRAM and GSRAM Has chiminite 
AppcWorks intemal menor: diniity increas 
Ing the aed auMber of records avitil 
ible from 6,000 to over 25,000 and only os 
RAM vind GSRAM Plus tnceise the number 
Of tines permitted. in the word) processing 
node from 6,000 to over 15,000. And only 
GSRAM cind GSRAM Plas offer a builtin 
printer buffer so vot Gan Continue Using 
Applaworks while vour printer is printing, Gs 
RAM vind GSRAM Plus even expand: the 
Humber of tines inthe dipboard trom: 255 to 
2007 anc will uit seymment Lire: files so they 
Cn be stvedion two or more disks: You can 


even have Pinpoint or Macroworks and your 
favorite spelling checker in RAM for instant 
response. GSRAM and GSRAM Plus will even 
dispkiy the time and date right on the 
AppleWorks screen. Nothing comes dose to 
enhancing AppleWorks so much 
Turn Your Iics into a Giant 

Simply plug GSRAM into the [IGs memory 
expansion slotand you've got up to & mega- 
bytes of RAM at your fingertips— all of it 
instantly and automatically recognized by the 
IlGs GSRAM is compatible with all [as 
software, induding AppleWorks, as well as 
BASIC®, ProDos, DOS 3.3, PASCAL®, “C” and 
CP/M®. 


Grow by Bytes or Megabytes 

We offer GsRAM in two configurations so 
you can increase your memory 256K at a 
time (GSRAM) of a megabyte at a time (Gs- 
RAM Plus). Both offer full compatibility, lower 
cost than other boards, and easy expandabil- 
ity. And both are extremely low in power 
consumption. A fully expanded GSRAM oper: 
ates at only 375 ma, and GSRAM Plus at only 
270 ma (even with 6 megabytes on board!) 
GSRAM—for Normal 
Memory Requirements 

GSRAM is available with 256K, 512K, 1 
MEG of 1.5 MEG of memory already on 
boar Ifyou don't need the full 1.5 MEG 
new, YOU Can Choose a GSRAM with less 
memory and expand it up to 15 MEG in the 
future or upyride to GSRAM Plus fora 
small Charge. 


dae qty: 
PovformManer 
compatihiltty. 
eNpatndahility and 
seppond Applaad 


Paencerme ssh AM 
and ARAM Mis one 
miontbher one 


Seve Wozniak, the creator 
Of Apple Computer 
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Insist on GSRAM’ 
When You Buy Your IIGcs’ 


Expand the Ilas RAM and ROM utth the GSRAM or GSRAM Plus 
with ROM Pak Available now with 256K to 8 MEG! 


With an optional piggyback card, you can 
expand GSRAM even higher than 1.5 MEG! 
(Other cards ire only expandable to 1 MEG.) 
GSRAM Plus—for Growing 
by Leaps and Bounds 

GSRAM Plus is the first Apple memory card to 
use | MEG RAM chips on the main board 
Its available with | to 6 MEG on board. If 
you don’t need the whole 6 MEG now, you 
can buy a GSRAM Plus with less memory and 
easily expand it in the future. 

GSRAM Plus can be expanded up to 8 
MEG with an optional piggyback card 
Easy Expansion 

Both GSRAM and GSRAM Plus use standard 
RAM chips that are readily available and just 
plug right in. So unlike other cards, you'll find 
expanding your GSRAM or GSRAM Plus easy, 
convenient and very economical And with 
our Opdonal ROM expansion module you 
can even increase the Hcs's ROM space and 
af in just one slot 
Quality and Support of the 
Industry Leader 

Applied Engineering is the langest supplier 
Of Apple peripherals in the work We 
duvented the first lange RAM cards for the 
Apple. With a S-year “no-hassle” warranty and 
outstanding technical suppor, you can be 
sure GSRAM and GSRAM Plus will deliver the 
performance you're looking for- or retum 
them within 15 days for a full refund 


GsRAM with 256K 
GsRAM with 512K 
GsRAM with 1 MEG 
GsRAM with 1.5 MEG 


GsRAM with 2-8 MEG 


GsRAM PLUS with 1 MEG 
Gs8RAM PLUS with 2 MEG 
GsRAM PLUS with 3-8 MEG 


Order today! 

See your deader or call Applicd Engineering 
tocty, 9am to Pl pm 7 chtys Or send 
check of money order to Applicd Engineer 
ing MasterCard, VISA and COLD. welcome. 

| Texas residents addltit. sides tix. Ad $10.00 


outside: EUSA 


AE APPLIED ENGINEERING” 
The Apple enbancement experts. 
| (214) 241-6060 


PO) Hon COR. Currelfton, EN "S00 


CP Nae ce neepestecneceD tose feconnerh oot Conpental Meese, 
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>FROM 3,10 (the macro call) 

LDA #10 (the generated lines) 
LDY #3 - 

JSR SET.X1.Y1 _ 


>BOX.TO 9,13 (assumes X1,Yl1 already set) 
LDA #13 

LDY #9 

JSR BOX 


>BOX 3,10,9,13 will generate a >FROM and a >BOX.TO 
macro call, which will then be expanded. 


Drawing Diagonal Lines: 


Or, more properly, “Drawing Lines from Any Point to Any Other 
Point". In Applesoft Hi-Res graphics you can use “HPLOT x,y TO 
x2,y2". I wrote a similar subroutine in lines 2300 and 
following. This subroutine assumes you have already stored the 
coordinates of the beginning of the line in Xl and Yl, and that 
the coordinates of the end of the line are in the A- and 
Y-registers. (Just like BOX did.) 


To make it easy to write program which draw lines, I defined 
some more macros. Use >FROM to set up Xl and Yl, just as with 
BOX. Use >LINE.TO to draw a line from that point to another. 
Use >LINE if you want to specify both ends at once. After a 
line has been drawn, Xl and Yl will contain the coordinates of 
the end of that line; this means that you can draw a continuous 
path around the screen by using a string of >LINE.TO calls. 


The algorithm for drawing a straight line from one point to 
another is probably not familiar to all. I believe it was 
developed many years ago (mid 50's?) for the early XY-plotters. 
My implementation may be a little hasty, because I seem to 
remember there is a simplification that involves shuffling 
variables around to fold two cases into one, but it does work, 
is quick, and does not require any multiplication or division. 


To be sure I had it right, I first wrote a lo-res line-drawing 
program in Applesoft. Here is the listing of that program to 
h2zlp you understand the assembly language in my LINE routine. 


100 GR : COLOR= 15 
110 INPUT X1,Y1,X2,Y2 
GosuB 1060 


120 
130 GOTO 110 
st Sone oye compe (y),2. 

LOR= INT D (1) ® bd 
220 X1 = INT ( RND : ee vee 
230 Y1 = INT ¢ RND # 40 
240 X2 = INT ( RND ®# ho 
250 Y2 = IN RND ® 40 
270 Tr PEEK. an 128 

- < 128 THEN 210 

280 one - 16368,0 


290 EN 

1000 REM PLOT X1,Y1 

1010 REM IN LO-RES W TT XCORRENT COLOR 
= ABS (x2 - X1):DY = ABS (Y2 - Y1 

1030 SX = SGN (X2 - X1):SY = SGN (Y2 - Y1 

1080 X = X1:Y¥ = Y1 

1050 IF DX < DY THEN 1200 

1060 D = DX - DY 

1070 PLOT X,Y 


b< 
o 
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1080 D = D = DY:X = X + SX: IF D < 1 THEN Y = Y + SY:D = D + DX 
1090 IF X < > X2 THEN 1070 
1100 PLOT x2,Y2 
1110 RETURN 
1310 PLOS XU Ye 
1220 D = D -'DX:Y = Y + SY: IF D < 1 THEN X = X + SX:D = D + DY 
1230 IF Y< > ¥2 THEN 1210 
1240 PLOT X2,¥2 
1250 RETURN 
1010 ®SAVE S-DOUBLE LO-RES 
1948 : -OP 65C02 
2c- 898 yo 7-7 .EQ $2C 
2p 1090 Y2 -EQ $2D 
30- 10 0 COLOR :EQ $30 
F800- 1080 PLOT .EQ $F300 
FB64- 1090 SETCOL .£Q $F864 
1110 .MA FROM 
1120 LDA 2 Y1 
1130 LDY #]1 x1 
1140 JSR SET.X1.Y1 
a. 
1170 .MA LINE.TO 
1180 LDA #12 Y2 
1190 LDY #11 x2 
1200 JSR LINE 
1210 EM 
1390 ‘MA LINE 
i3ko SF ROH pir j2 x1,Y1 
1250 >LINE . 3,]4 X2,y¥2 
1370 # 
1360 .MA BOX.TO 
1290 LDA #]2 Y2 
1300 LDY #]1 X2 
1310 JSR BOX 
1330 eee RE COA To cee ee E 
i 0 PROM 2. =Xx1,Y1 
é0 >BOX. 44° J4 X2:y2 
Le eee ea 
1390 T 
O800- 20 8A 08 1400 JSR DLR Turn on Double Lo-Res 
0803=- 20 DF 08 1410 JSR CLRTOP Clear screen 
ta Ag OF 1420 LDA #15 Set Color = White 
0808- 20 64 F8 1430 JSR SETCOL 
pene 14 0 #.--DRAW DIAGONAL LINESSteco3522 
0819- 1420 SLINE 0°3 é 
0827- 1470 >LINE 79, 39,46 
0835- 1480 NE 79,0,4 i 
1490 #---BOX, 3515 TO: 44, Boseccocaces 
0843- 1500 BOk 35,15,44,2 
1210 ®---BORDER AROUND "SCRE awenonaa= 
0851- 1520 >LINE 0,0,79,0 
O85F- 1530 SLINE.Td 79 39 
0866- 1540 SLINE . TO +3 
086D- 1550 : >LINE.TO 0, 
O874- AD 00 CO 1570 62 LDA $C000 
0877- 10 F 1580 BPL .2 
0879- 8D 10 CO 1590 : STA $C010 
087 20 80 08 1610 JSR TEXT 
O87F- 60 1620 ; RTS 
0880- 8D 51 CO 1640 an STA $C051 TEXT 
088 Bp 2F CO 1€00 STA ic05r SINGLE 
8D 54 CO 1670 STA $C054 
0889- 60 1680 RTS 
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1690 #&-------------------------------- 
1700 DLR 
O88A- AQ 99 1710 LDA £399 
088C- 20 00 C3 1720 JSR 30 TURN ON 80-COLUMN MODE 
O88F- 8D 50 CO 1485 STA 050 GRAPHICS 
0892- 8D 53 CO 1740 STA 05 MIXED TEXT/GRAPHICS 
0895- 8D 54 CO 1750 STA 05 START IN MAIN MEM 
0898- 8D 56 CO 1760 STA 056 LO-RES 
O89B- 8D 5E CO The STA 05E DOUBLE 
O89E- 60 1780 RTS 
1130 #2 ee ee = 
1800 DPLOT.X1.Y1 
O89F- AD BF 09 1810 LDA Y1 
O8A2=- AC BE 09 1820 LDY X1 
08A5- Ra 1830 DPLOT PHY 
O8A6- § 1840 PHA SAVE Y-COORD 
O8AT—- 1990 TYA X-COORD 
OSAS=- 4A 1860 LSR 
O8Aa9- A8 1870 TAY X/2 
O8AA- 68 1880 PLA 
O8AB- 48 ee PHA 
O8AC- BO 03 1900 BCS .1 
O8AE- 8D 55 CO 1910 STA $C055 
O8Bi- 20 00 F8 1920 .1 JSR PLOT 
O8B4- 8D 54 CO Lae STA $C054 
O8B7- 68 1940 PLA 
O8BS—- 7A 1950 PLY 
O8B9- 60 1960 RTS 
1970 $e nen non ne nee e-== 
O8BA- C8 19380 HLIN1 INY 
O8BB- 20 A5 08 1990 HLIN JSR DPLOT 
O8BE- C4 2C 2000 CPY xX 
O8CO- 90 F8 2010 BCC HLIN1 
O8C2- 60 2020 
2030 Seen nn nnn nn nnn ne nee en = 
08C3- 69 01 2040 VLIN1 ADC #1 
pocRe 20 A5 08 2050 VLIN JSR DPLOT 
O8CS=- C5 2D 2060 CMP Y2 
O8CA=- 90 F7 2070 BCC VLIN1 
O8CC- 60 2080 RTS 
2090 Bann nw nw nnn wn wn no en eee 
ee ; BOX X2 IN Y, Y2 INA 
O8CD- 20 B6 09 2120 BOX JSR SET.X2.Y2 
O8DO- AD BF 09 2130 LDA Y1 
O8D3- AC BE 09 2140 .1 LDY X1 
O8D6—- 20 BB 08 2150 JSR HLIN 
O8D9- C5 2D 2160 CMP Y2 
O8DB- 1A 2170 INC 
O8DC- 90 F5 2180 BCC .1 
O8DE- 60 2190 RTS 
2200 Bonn nn nn wn nn nnn nn ww ne ene 
O8DF- AJ 00 2210 CLRTOP LDA #0 
O8E1- 85 30 2220 STA COLOR 
08E3- 2230 SETTOP >BOX 0,0,79, 39 
O8Fi- 60 2240 RTS 
2250 SB emw mn nnn mewn en nnn nnn nn ene new 
2260 ® LINE FROM X1,¥1 TO X2,Y¥2 
2270 # X2 IN Y, Y2 IN A 
2280 #------- ee ene ee ee ee nw oe 
O8F2- 20 B6 09 2290 LINE JSR SET.X2.Y2 
OSF5—- A2 01 2300 LDX #1 First Y's, then X's 
O8F7- AO 00 2310 .1 LDY #0 START WITH SGN()=0 
O8F9- 38 2320 SEC 
O8FA- B5 2C 53h0 LDA X2,X X2 or Y2 
O8FC- FD BE 09 2340 SBC X1,X X1 or Y1 
O8FF- FO 08 2350 BEQ .3 VERTICAL or HORIZONTAL 
0901- 10 05 2360 BPL .2 Positive DELTA X or DELTA Y 
0903- 88 2370 DEY Negative DELTA X or DELTA Y 
O904- 49 FF 2380 EOR #$FF 2's Complement 
0906— 1A 2390 INC 
0907- 88 2400 DEY (overcome following INY) 
0908- C8 2410 .2 INY SGN() = -1, 0, +1 
0909- 9D C2 09 2420 .3 STA DX,X DX or DY 
090C- 98 2430 TYA 
O90D- 9D CO 09 2440 STA SX,X SX or SY 
0910- CA 2450 DEX 
0911- 10 E4 2460 BPL .1 
DN 0: Biecwen eo oe oe so ees se cess seese tee 
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Global communications. 
Down-to-earth price. 
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Introducing the Datalink modem. 
Get instant access to networks and databases 
—plus network memberships and discounts worth $177.95! 


Now you can tap into a world of information — without 
draining your resources. Our Datalink'“ modem lets your Apple 
1IGS, He or I+ communicate with other computers, download 
free software from networks and bulletin boards, access 
database services and more. For a remarkably low price. 


The world at your fingertips. 

With the Datalink modem, you'll be able to draw informa- 
tion from thousands of databases. Send and receive electronic 
mail — even overseas. Join clubs and bulletin boards to 
exchange software or solve computing problems with other 
Apple users. Download free public domain software. And 
share files with personal computers and mainframes. 

There’s nothing missing 

on Datalink. 

Unlike the Smartmodem® 
Datalink comes with its own easy- 
to-use communications software 
in ROM and on disk that supports 
macros, file transfers, on-line 
time display, data capture and 
datascope mode. The software 
also allows you to store hundreds 
of phone numbers for auto dial- 
ing and log on. 

Because Datalink is 100% 
Super Serial Card compatible, you 
can also run virtually all other 
communication software, including 
Point-to-Point, Apple Access and 
ASCH Express, to name a few. 


Price 


Warranty period 


Hayes AT 
command set 
On-board 
telephone jacks 


Fits any slot 
(even with fan) 


$219 
1200 baud 


5 years 
at no charge 


Software included 


The compact design allows Datalink to fit in any slot — 
including slots 1 and 2 of the IIGS with a cooling fan 
installed. Datalink operates at 1200 or 300 baud. Built-in 
diagnostics check for accuracy of data transmission, and 
Datalink lets you track the progress of calls either elec- 
tronically or via an on-board speaker. 


Introductory offers from popular networks included. 
When you purchase Datalink, you'll get a fee-waived mem- 
bership to The Source worth $49.95. $60.00 worth of free 
on-line time from News Net. A free $50.00 subscription to the 
Official Airline Guide. A free subscription to the GEnie net- 
work worth $18.00! And information on MCI Mail. 


Order today! 


Applied ; Hayes To order or for more informa- 
Engineering Smarimodem tion, see your dealer or call 
Datalink 1200A > : 


Applied Engineering today, 9 a.m. 
to Il pm. 7 days. Or send check 
or money order to Applied 
Engineering. MasterCard, VISA 
and C.0.D. welcome. Texas resi- 
dents add 61% sales tax. Add 
$10.00 outside U.S.A. 


$439 
1200 baud 


2 years or 
4 years for $75 


Fe Applied Engineering 


The Apple enhancement experts. 


Box 798, Carrollton, TX 75006 
(214) 241-6060 


Smarimodem is a registered trademark of D.C Haves Corporation 
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Cc 
NO 
Bs 
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fa 
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AD C3 09 2490 LDA DY 
ED C2 09 2500 SBC DX DY-Dx 
10 43 2510 BPL .8 ~2e-DX < DY 
49 FF 2520 EOR #$FF 2'S COMPLEMENT 
1A 2530 INC 
8D C4 09 2540 STA D 
20 9F 08 2550 .5 JSR DPLOT.X1.Y1 
18 2560 CLC 
AD BE 09 2570 LDA X1 
6D CO 09 2580 ADC SX 
8D BE 09 2590 STA X1 
38 2600 SEC 
AD C4 09 2610 LDA 
ED C3 09 2620 SBC DY 
8D C4 09 2630 STA D 
FO 02 2640 BEQ .6 
10 13 2650 BPL .7 
18 2660 .6 CLC Y = Y + SY 
AD BF 09 2670 LDA Y1 
6D C1 09 2680 ADC SY 
8D BF 09 2690 A Y1 
C4 09 2700 LDA D D=D + DX 
6D C2 09 2710 C DX 
8D CH 09 2720 STA D 
AC BE 09 $720 oT LDY X1 
C4 2C 2740 CPY X2 
DO CB 2750 BNE .5 
A5 2D 2760 LDA Y2 
D BF 09 2770 STA 
C A5 08 2780 JMP DPLOT 
9700 Bicsecnacoscveacceosctussseceseus 
8D C4 09 2800 .8 STA D 
20 OF O08 2810 .9 JSR DPLOT.X1.Y1 
18 2820 CLC 
BF 09 2830 LDA Y1 Y = Y + SY 
6D C1 09 2840 ADC SY 
8D BF 09 2850 STA Y1 
3 2860 D=D - Dx 
AD C4 09 2870 LDA D 
ED C2 09 2880 DX 
8D C4 09 2890 STA D 
FO 02 2900 BEQ .10 ~e-D = 0 
10 13 2910 BPL .11 oeeD > O 
18 2920 .10 CLC X = X + SX 
AD BE 0 3330 LDA X1 
D CO 09 2940 SX 
8D BE 09 2950 STA X1 
C4 09 2960 LDA D D= D + DY 
D C3 0 33 0 DY 
D C4 09 2 STA D 
AD BF 09 2990 .11 LDA Y1 
C5 2D 3000 CMP Y2 
DO CB 010 BNE .9 
A4 2C 020 LDY X2 
8C BE oe 300 STY X1 
4c A5 O 040 JMP DPLOT 
070 femme mmm wn enn ee weno eee een nen 
000 LIMIT.XY 
C9 28 oh CMP #40 
90 02 080 BCC . 
AQ 2 3090 LDA #39 
CO 5 3100 .1 CPY #30 
90 02 3110 BCC . 
AO 4F 3120 LDY #79 
60 3120 2 RTS 
140 Sennen nn nw nw no enn ewe n ener ee== 
226 SET.X1.Y¥1 
20 9F 09 3160 R LIMIT.XY 
C BE 93 3100 STY X1 
D BF 0 180 STA Y1 
60 190 RTS 
200 #-----~---- oe eee O9BE- 
210 SET.X2.Y2 O9BF- 
20 9F 09 3220 JSR LIMIT.XY 09C0- 
84 2C ai STY X2 09C 1- 
85 2D 240 STA Y2 09C2- 
60 at RTS 09C3- 
2060 #----------- eee eee o9c4- 


Wh) Ow ~~] 
CoOoOoooCoo°o 
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Patch .TF to Assemble System Files........-Bob Sander-Cederlof 


The ProDOS version of S-C Macro Assembler can put your object 


code directly on a target file, by using the 
The way it is designed, you have no 


Specify the file name. 


control over the file type: 


which is type $06. 


Well, let's change it then! 


need it. 


TF directive to 


it always comes out type BIN, 


Sometimes it would be nice to be able to 
have the file end up a different file type, such as SYS (SFF), 
but no such capability is available in the S-C Macro Assembler. 


At least temporarily, whenever we 
If such a patch is possible, we could make an EXEC 


file to install the patch whenever we need it, and simply 
re-load when we want to go back to normal. 


The code which handles the 


TF directive is located somewhere 


between $8F70 and $9000, depending on the particular serial 
number you have. 


the following code somewhere between $8F70 and $9000. 


The way to locate it in yours is to look for 


(Use the 


monitor L command to do the looking.) 


AS 00 
8D C8 
8D C9 
8D CA 
AD DO 
85 98 
8D C7 
AS CE 
20 70 
A9 DO 
20 70 
BO ee 
AS OA 
8D B4 
AS C4 
20 70 
BO .. 
A9 07 
8D B4 
** AD 06 
8D B8 
A5 BC 
8D B9 
AS BD 
8D BA 
AS C3 
20 70 
BO .. 


It is the starred line 
to get a differenct file type. 
would get type SYS files for 


BE 


BE 


BE 


BE 


BE 


BE 


BE 


BE 


LDA 
STA 
STA 
STA 
LDA 
STA 
STA 
LDA 
JSR 
BCS 
LDA 
JSR 
BCS 
LDA 
STA 
LDA 
JSR 
BCS 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
JSR 
BCS 


#0 
SBEC8 
SBEC9 
SBECA 
SBEDO 
$98 
SBEC7 
#SCE 
SBE70 
#SD0 
SBE70 
#SO0A 
SBEB4 
#$C4 
SBE70 


TF directives. 


Set Mark = 000000 


Set End-of-File = 000000 


10 Parameters 


Get File Info 


7 Parameters 
File Type = $06 (BIN) 


Lo-byte of Origin 
into AuxType 
Hi-byte of Origin 

into AuxType+t+l 
Set File Info 


ee -Crror 


"LDA #$06" which we would need to change 


By changing it to “LDA #SFF" we 
We might also 


want to change the lines which store into the AuxType field. 
AuxType holds the Load Address for BIN files, but SYS files 
always load at $2000 so AuxType is not used. 
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Once you find the code above, and determine the address of the 
file type value (the 06 in the LDA #$06 instruction), you can 
Change it with a simple monitor command. Or, you could get 
fancy and write a program to do the searching for you and make 
the patch. 


And I wrote just such a program! The following code will 
search for the patch location, and if it finds $06 in the file 
type address it will change it to SFF. If it finds anything 
else there, it will change it back to $06. And it will print 
out a message telling which one it did. 


1000 *SAVE S.PATCH. TF 
FDED- loko MON.COUT EQ FDED 
FD8E- 1050 MON.CROUT -BQ $FDBE 

oe ee ge 
0800- A9 00 1080 LDA #38200 START LOOKING AT $8E00 
D808. As Be 1980 LDA PaToo 
0806- 85 01 1110 STA PNTR+1 
0808- A000 1130 «1 LDY 0 
ae ee a aa 
Bore FO 1) 1180 BEQ .3° .. MATCHES SO FAR 
0 11- E6 00 1170 ING PNTR SLIDE WINDOW DOWN ONE 
0815- E6 01 1190 INC PNTR+1 
0817- A501. ~—«-:1200 LDA PNTR+1 STOP BEFORE IT GOES TOO FAR 
0819- C9. 91. ~—s-: 1210 CMP /$9100  $90RF_IS PLENTY FAR ENOUGH 
O81B- 90 EB: 1220 BCC . *. NOT THERE YET 
OB1D- AO 00, 1230 LDY #Q. NOT.FOUND 
O81F- kc 4D 08 1240 JMP MSG. OUT 
0822- C8 1380.3 INY NEXT BYTE IN KEY AND WINDOW 
0823- GO 06 1270 CPY #KEY.LEN 
0827- AO 06 1300 . LDY #PLOC-KEY 
0829 - BI 09 1310 LDA (PNR), GET CURRENT FILETYPE 
082D- FO 0 1339 BEQ . .. NOW "BIN", MAKE IT "SYS" 
O82F- AQ 0 1340 LDA #$06 “NOT OTHER, MAKE IT "BIN" 
0831- 91 00 1350 STA (PNTR),Y 
0833- AO OD 1360 LDY #Q.MADE. 
0835- 4C 4D 08 1310 : JMP MSG. OU 
0838- AQ FF 1390. LDA #$FF MAKE IT TYPE "SYS" 
O83A- 91 00 1400 STA (PNTR) 
O83C- AO 26 1410 LDY #Q.MADE. 
083E- 4C 4D 08 1420 . JMP MSG. 
SB 18 Oh og Ha ST 
oe ee A9 1460 "HS AQ "LDA" OF "LDA #$06* 
0847 - 1470 PLOC .:EQ # 
06- 14 O KEY.LEN’ — .EQ 8-KEY 
0847- 09 80 1500 MSG1 ORA #$80 
0849- 20 ED FD 1510 JSR MON .COUT 
OB4C- CB 1520 usc. ores 
oo ee 
0852- 20 ED FD 1560 JSR MON .COUT 
0855- 4C 8E FD 1570 JMP MON .CROUT 
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1590 QTS 

00- 1600 Q.NOT.FOUND .EQ ®-QTS 

0858- 4B 45 59 

O85B- 20 4E 4F 

OB5E- 54 20 46 

0861- GF 55 4E 

O864- Ch 1518 ~AT /KEY NOT pees 

Ope aa 4 1620 Q.MADE.BIN -EQ #-QTS 

Si: 80 4) F8 

O86B- 44 20 , 

O86E- 4F 20 46 

0871- 49 hc 45 

OB74- 54 59 50 

0877-45 20 32 

O87A- 42 49 hE 

O87D=- A2 16 30 AT /PATCHED ae FILETYPE "BIN"/ 
- 1e 0 Q. MADE. SYS -EQ *-QTS 

OBbT. Rg Ag he 

O881- 43 48 Ks 

O88h- 4h 20 54 

O887- NF 20 46 

OBBA- 49 ic 4 

O88D- 54 59 5 

0890- 45 20 22 

0893- 53 59 53 

0896- A2 1650 7 AT /PATCHED TO FILETYPE "SYS*"/ 


Ter Golt  sasic-tike Macros for the S-C Macro Assembler. These macros are 
‘Integer Basic Macros which can perform most of the standard Basic 
commands using 8/16/52/64 bit manipulation. Incduded area set of 
graphic commands to perform block graphics and other Hi-Res 
Animation. Available in either DOS 3.3 or ProDos Format. Either one 
for $30.00 or BOTH for $50.00. 


A Shape A shape table program unlike any other program you have ever run. 

Table This one is completely set up in a logical manner. All disk operations 
are under one section. All editing functions are contained in one 

Bro gram: place. All Hi-Res functions are in one place. The entire source code 
is included to allow you to modify it as you need to! The DOS 3.3 
Version is only $20.00 - AND 80 18 THE PRODOS VERSION!!! Both 
Versions for only $30.00. ORDER YOURS TODAY!!! 


To Ovder:& send check or Money Order To: Upgrades for EnterSoft from DOS 


5.3 to ProDos ts $20.00. Get yours 
today! 


4, 4 
Thanks Everyone For Your 
Comments and Support! 
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Mark Manning 

c/o Simulacron 1/Baggy Games 
P.O. Box 591894 

Houston, Tx 77259-1894 


CECCEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


SPECIAL !!! EXPANDED RAM/ROM BOARD: $39.00 
Similar to our $30 RAM/ROM dev board described below. Except this board has two sockets to hold your choice 
of 2-2K RAM, 2-2K ROM or even 2-4K ROM for a total of 8K. Mix RAM and ROM too. Although Apple limits 
access to only 2K at a time, soft switches provide convenient socket selection. Hard switches control defaults. 


IMPROVED ! 1! JL IN A MAC (ver 2.0): $75.00 
Now includes faster graphics, UniDisk support and more! Bi-directional data transfers are e snap! This Apple Il 
emulator runs DOS 3.3/PRODOS (including 6502 machine language routines) on a 512K MAC or MACPLUS. All 
Apple |! features are supported such as HI/LO-RES graphics, 40/80 column text, language card and joystick. 
Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk accessories and support 
for 4 logical disk drives. Includes 2 MAC diskettes (with emulation, communications and utility software, plus 
DOS 3.3 and PRODOS system masters, including Applesoft and Integer BASIC) and 1 Apple II diskette. 


SCREEN.GEN: $35.00 
Develop HI-RES screens for the Apple Il on a Macintosh. Use MACPAINT (or any other application) on the MAC to 
create your Apple {i screen. Then use SCREEN.GEN to transfer directly from the MAC to an Apple Il (with 
SuperSerial card ) or lic. Includes Apple I! diskette with transfer software plus fully commented SOURCE code. 


MIDI-MAGIC for Apple //c: $49.00 
Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MiDI-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-4AGIC compatible 
with Apple I! family using Passport MIDI card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. Special functions (like expanded, compressed etc.) supported. 
Includes HIRES screen editor to create custom fonts and special graphics symbols. For Apple Il, iit. //e. Specify 
printer: Apple Imagewriter Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 80/85, or Okidata 92/192. 
* FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e : $30.00 ($50.00 with SOURCE Code) 
Use this intelligent disassembier to investigate the inner workings of Apple |! machine language programs. 
DISASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
assemblers. Handles data tables, displaced object code & even provides label substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASM is “absolutely essential” in his ASSEMBLY COOKBOOK. 


The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 

Converts a ‘dumb’ parallel printer |/F card into a ‘smart’ one. Simple command menu. Features include 
perforation skip, auto page numbering with date & title. large HIRES graphics & text screen dumps. Specify 
printer: X-80 with Graftrax-80, MX-100, MX-80/100 with Graftraxplus, NEC 8092A, Cltoh 8510 
(Prowriter), OkiData 82A/83A with Okigraph & OkiData 92/93. 

‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation's Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing. true dialtone 
detection, audible ring detect, ring-back, printer buffer, 80 col card & shift key mod support. 

RAM/ROM DEVELOPMENT BOARD: $30.00 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $Cn00-CnFF and $CG00-CFFF. 
C-PRINT For The APPLE //c: $69.00 


Connect standard parallel printers to an Apple //c serial port. Separate P/S included. Just plug in and print! 


Unless otherwise specified, all Apple I diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid a $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
SCEECEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
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Viewing Appleworks Word Processor Files...Bob Sander-Cederlof 


I don't happen to be an owner of Appleworks. This may be the 
tiniest minority of which I am a member. However I do see a 
lot of type AWP files on disks you send me. Problem, how do I 
really “see® them? I need a way to list them to the screen so 
that they look the way you wrote them: a WISIWYS lister (What 
I See Is What You Saw). It strikes me now that people who are 
trying to “hear” the files using a Speech Synthesizer might 
also need some special lister. 


I have been doing it by BLOADing the file I need to see, 
specifying a starting address and file type, like this: 


:BLOAD MSG.TO.SC,A$1000,TAWP 


That leading colon is the prompt from the S-C Macro Assembler, 
which is usually where I am when I do the BLOAD. Then a 
hex-dump with ASCII on the right, lets me read it. But it is 
an uncomfortable way to read. 


I looked up the format of the Appleworks Word Processor files, 
and decided to write a quick-and-dirty lister. The first 300 
bytes of a type AWP file are of no interest to my lister. This 
header contains the tab stops and a few flags, and I don't know 
what else. My documentation is from February 1984, and most of 
the bytes were undefined at that time. I presume they are 
better defined now that over three years of improvements have 
been made to Appleworks, but I don't have that documentation. 


If I BLOAD at address $1000, then 300 bytes in starts at $112C. 
From there to the end of file there are basically two types of 
data records: commands and text. Commands are two-byte 
records, and text lines consist of a four-byte header and a 
variable amount of text. 


You distinguish whether a record is a command or text line by 
looking at the second byte. If it is 00, you have a text line. 
If it is $DO-SFF, you have a command. If it is anything else, 
I don't know what you have. Maybe garbage? 


If the second byte of a record is $DO or larger, indicating a 
command, then the first byte of the record may contain more 
information for the command. The most frequent command is §$D0, 
which means a carriage return command. In my lister I simply 
output a carriage return when I see this command. Another 
popular command is SFF, which means end-of-file. Obviously, 
when my lister finds this code it is time to end the listing! 
All the other codes I chose to simply list in hexadecimal. To 
distinguish them from text they list on separate lines of the 
form “.S$xx.$yy", where xx is the command code (second byte) and 
yy is the operand value (first byte). 


Text lines have the second byte = $00. The first byte of these 
records contains a byte count, but it is somewhat redundant: 

it is always two larger than another byte count found in bits 
6-0 of the fourth byte of the record. I chose to use this 
second byte count, which is the actual number of bytes of ASCII 
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RamWorks III 


Patented Performance from the Recognized Leader 


The Best Selling Most Compatible, Most 
kecommended, Most Expandable Card Available 


The AppleWorks Amplifier. 
While RamWorks III is recognized by 
all memory intensive programs, NO’ 
other expansion card comes close to 
Offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you'd expect RamWorks IIE to 
expand the available desktop, after all 


| 
| 
: 
| 


Applied Engineering was a vear ahead of | 


everyone else including Apple in offering 
more than 55K and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple's own card 
does not provide and oh: RamWorks III 
does. With a 265K or larger RamWorks 
TL, all of AppleWorks (induding printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the ime required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 

RamWorks eliminates AppleWorks 
intemal memory limits, increasing the 
maximum number of records available 
from 1,350 to over 22,000. Onh: Ram- 


? Works increases the number of lines 


pemnitted in the word processing mode 
from 2,250 to over 22,000. Orh: Raum- 
Works expands the maximum clipboard 
limit from 250 to 2,042 lines. And onh: 
RamW orks offers a built-in printer buffer, 
so you won't have to wait for your 
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printer to stop before retuming to 
AppleWorks. And auto segments large 
files so they can be saved on two or 
more disks. You can even have Pinpoint 
or MacroWorks and your favorite spelling 
checker in RAM for instant response. 
RamWorks, nothing comes close to 
enhancing AppleWorks so much 


The Most Friendly, Most 
Compatible Card Available. 

Using RamWorks HI couldn't be easier 
because its compatible with more off 
the-shelf software than anv other RAM 
card. Popular programs like AppleWorks, 
Pinpoint, Catalyst, MouseDesk, Howard: 
Soft, FlashCalc, Pro-FILER, Managing Your 
Money, SuperCalc 3a and VIP Profes- 
sional to name a few (and most 
hardware add on’s like ProFile and Sider 
hard disks). RamWorks is even compat 
ible with software written for Apple 
cards. But unlike other cards, RamWorks 
plugs into the He auxiliary slot providing 
our super sharp 80 column text (US. 
Patent #4601018) in a completely inte- 
grated system while leaving expansion: 
slots 1 through 7 available for other 
peripheral cards. 

RamW orks IIE is compatible with all 
Apple He's, enhanced, unenhanced, 
American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of 
fered the largest memory for the Ile and 


RamWorks IH continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 
most will ever need (1 MEG is about 500 
pages of text)...but if you do ever need 
more than 1 MEG, RamWorks HI has the 
widest selection of expander cards avail 
able. Additional 512K, 1 MEG, or 2 MEG 
cards just snap directy onto RamWorks 
Il by plugging into the industy’s only 
low profile (no slot 1 interference) fully 
decoded memory expansion connector. 


It Even Corrects Mistakes. 


If you've got some other RAM card 


thats not being recognized by your 


programs, and vou want RamWorks III, 
you're in luck Because all you have to 
do is plug the memory chips from your 
current card into the expansion sockets 
on RamWorks to recapture most of your 
invesument! 


The Ultimate in RGB Color. 
RGB color is an Option on RamWorks 
and with good reason. Some others 
combine RGB color output with their 
memory cards, but that’s unfair for those 
who don't need RGB and for those 
that do. Because if you don't need RGB 
Applied Engineering doesn’t make vou 
buy it, but if you want RGB output 
youre in for a nice surprise because the 
RamW orks RGB option offers better 


_ color graphics plus a more readable 80 


' column text (that blows away any 


composite color monitor). For only $129 
it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most 
claim is the best they have ever seen. 
Youll also appreciate the multiple text 
colors (others only have green) that 
come standard But the RamWorks RGB 
option is more than just the ultimate in 
color Output because unlike others, it's 
fully compatible with all the Apple 
standards for RGB output contol, mak- 
ing it More compatible with off-the-shelf 
software. With its FCC certified design, 
you can use almost any RGB monitor 
because only the new RamWorks RGB 
Option provides both the new Apple 
standard analog and the IBM standard 
digital RGB outputs (cables induded). 
The RGB option plugs into the back of 
RamWorks with no slot 1 interference 
and remember you can order the RGB 
option with your RamWorks or add it on 
at a Liter clate. 


ColorLink™ 
RGB Option 


True 65C816 16 Bit Power. 

RamWorks HI has a built-in 65C816 
CPU port tor direct connection to our 
optional 65C816 car The only one 
capable of linearly addressing more than 
1 MEG of memory for power applica 
tions like running the Lotus 1-2-3" 
compatible program, VIP Professional 
Our 65C816 card does not use another 
slot but replaces the 65C02 while main- 
taining full 8 bit compaubility. 


Endorsed by the Experts. 

A+ magazine said “Applied Engineer- 
ing’s RamWorks is a boon to those who 
must use large files with AppleWorks... 
like the product so much that} ium 
buying one for my own system” inCider 


magazine said “RamWorks is the most 
powerful auxiliary slot memory: card 
available for your He, and [rate it four 
stus..For my money, Applied Engineer: 
ing’s RamWorks is king of the hill” 


“T wanted a 
memory card for 
my Apple that was 
fast. easy lo use, 
and very compat. 
ible; so 1 bought 
“A RamWorks ~ 
Steve Wozniak. the creator 

of Apple Compitter 


Apple experts everywhere are im- 
ressed by RamWorks’ expandability, 
versatility, ease of use, and the sheer 
power and speed that it adds to any Te. 
With a RamWorks in your Apple, you'll 


make IBM PCs and ATs look like 
slowpokes. 


Quality and Support of the 
Industry Leader. 
RamWorks I is from Applied Engi- 
neering, the largest, most well supported 
manufacturer of Apple peripherals and 
the inventor of kage RAM cards for the 

Apple. With our 5 year no hassle 
waranty and outstinding technical sup- 
port, you're assured of the most trouble 
free product you can buy. 


It's Got It AIL 

e 15 day money back guarantee 

e 5 year hassle free warranty 

e Built-in super sham 80 column dispkiy 
(US. Patent #4601018) 

e Expandable to | MEG on main cud 

e Expansion connector for possible 
future expansion to 16 MEG 


e Can use O4K or 250K RAMs 

e Powerful linear addressing 16 bit 
coprocessor port 

e Automatic AppleWorks expansion up 
to 3017K desktop 

e Accelerates AppleWorks 

e Built-in AppleWorks printer buffer 

e 100% compatible with all standard He 
software 

e RamDrive™ and ProDrive™ the ultimate 
emulation software included free | 

e Memory is easily partitioned wowing | 
muny programs in memory at once 

e Compatible RGB option featuring ultra 
high resolution color graphics and 
multiple text colors with cables for 
both the new Apple and standard IBM 
\pe Monitors 

e Self diagnostics software included 

e Lowest power consumption (U.S. 
atent #4601018) 

e Takes onl one slot (auxiliary) even 
when fully expanded 

e Socketed and user upgradeable 

e Software indusry stanciard 

e Achunced Computer Aided Design 

e Used by Apple Computer, Steve 
Wozniak and virtually: all software 
companies 

e Displays date and time on the Apple- 
Works screen with any PRO-DOS 
compatible clock 

e Much, much more! 


RamWorks Ill with 64K 
RamWorks Ill with 256K 
RamWorks (il with 512K 
RamWorks Ill with 1 MEG 
RamWorks lil with 1.5 MEG 
RamWorks ili with 3.0 MEG 
Ram Expander+ 1 MEG 


$179 
$199 
$249 
$329 
$489 
$1099 
$499 
$799 
$159 
$129 


Ram Expander+ 2 MEG 
65C816 16 Bit Card 


$79 
$219 


RamWorks HL The industry standard 
for Memory expansion of the Apple Ile. 
ORDER YOUR RamWorks TI TODAY. 
See your dealer or call (214) 241-6060, 
9am to lpm, 7 days or send check 
or money order to Applied Engineering, 

MasterCard, Visa and CO.D. welcome. 
Texas residents add 64% sles tu Add 
$10.00 if outside USA 


HE. APPLIED ENGINEERING” 


The Apple enbancement experts 
(214) 241-6060 | 


P.O. Box 798, Carroliton, TX 75006 
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and control codes which follow the four-byte header. The third 
byte of the text line header is supposed to be a leading blank 
count for the line, but I haven't found anything but zero there 
in the files I have viewed. Anyway, I chose to ignore this 
byte in my lister. The sign bit of the fourth byte indicates 
whether or not a carriage return should be tacked onto the end 
of this line. 


In a paragraph, separate screen lines will be separate text 
line records. All except the last line will have bit 7 of the 
fourth header byte = zero, while the last line of the paragraph 
will have that bit = one. In my lister I decided to allow two 
ways of viewing the file. If you assemble with WRAP in line 
1020 = 0, a file will list with carriage returns at the end of 
every text line record. This makes it look like it did inside 
‘the Appleworks Word Processor. If you change line 1020 to WRAP 
-EQ 1, no carriage return will be listed until the end of the 
paragraph. 


Within text line records you have both ASCII characters 
($20-S$7F) and control codes (S$0O0-Sl1F). The control codes are 
NOT the same as ASCII control characters. They have special 
meaning within Appleworks. The documentation I have defines 
codes $01 through $0B as follows: 


Begin End 
01 02 Boldface 
03 04. Superscript 
05 06 Subscript 
07 08 Underline 
09 -- Print Page Number 


OA -- Enter Keyboard 
OB -- Sticky Space 


I converted $0OB (sticky space) to $20 (ASCII space). A sticky 
Space is supposed to print as a space, but not allow splitting 
at that point at the end of a line. All of the other codes I 
chose to simply ignore. You could obviously do something 
special with them. Either act intelligently and do on the 
screen or printer what they are supposed to do, or simply print 
them out as “<xx>" or the like. 


You could add code to this lister to make it into a super-duper 
program. I thought about adding the front end to my ProDOS 
QUIT code program (from July, 1986 AAL). I would change the 
file type selection from that front end from SYS and BIN to 
AWP. Then I could easily find any AWP file on any mounted 
volume using the arrow keys, and BLOAD it with the RETURN key. 


The next nice addition would be an output option section that 
would allow sending the output to a printer, speech 
synthesizer, or a TXT file. 


If you do add either or both of these, or some other nice 
features, how about sending them here? 
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1000 *SAVE LIST. AWP 


1020) Weecet eect oe eee eee 
00- RS WRAP -EQ O for CR at end of each line 
13 6 4 1 for CR only at end of paragraph 
00- 1089 3 .EQ $00,01 
FD8E- 1060 CROUT .EQ $FD8 
FDDA- 1090 PRBYTE .EQ $FDDA 
FDED- 1100 cOUT . EQ 
1120 T 
opog Be BSA tRe ee 
O80 = Ag 11 1190 LDA /$1000+300 
0806- 85 01 i 0 : STA P+1 
o08- xo 0) 1180 «1 EY fi 
Seog. BO RF Neto BEQ 52, ‘TEXT LINE 
0810- FO 3D 1220 BEQ . END OF FILE 
0812- C9 DO 1230 CMP #3D0 
0814— FO 09 1240 BEQ . 
gigs gf 2 08 tag 
081A- B1 00 1270 LDA (P),Y 
081C- 20 50 08 1280 JSR PRB 
ghee go GED taae ows iBegin 
O82h- 20 5F 08 1310 JSR BUMP 
0827- 4c 08 08 1320 F JMP .1 
O82A- AO 0 1 rf ce. LDY #3 
082C- B1 0 50 a ups ),Y¥ | LENGTH OF TEXT BYTE 
1 10 ° PHA SAVE FOR CR FLAG 
1380 .FIN 
082E- 29 7F 1390 AND #$7F 
0830- 1400 TAX # CHARS IN LINE 
eee: auc ipa Y 
a A A a pe 
OB 3- cg OB 1450 GHP ; OB Sticky SPACE? 
A- e eee 
OR RE 9 ED FD 1490 ° JSR COUT 
0843- CA 1500 .36 DEX 
OE 0 moe bo wie 
1530 : PLA 
13 0 BPL .4 
1 20 .FIN 
0846- 20 8 1560 JSR CROUT 
0849- 20 5F 08 1570 4 JSR BUM 
O84C- 4C 08 08 1380 ‘ JMP , 
S850 A ag 1830 PH RL a 
0853- 20 ED FD 1680 JSR COUT 
0856- AQ AN 1650 LDA #"$" 
SRGE- gg HD mm igs gny Cots 
085C- 4C DA FD 1660 : JMP PRBYTE 
O88 - 8 1700 BUMP TYA 
0860- 38 1710 SEC 
0861- 65 00 1720 ADC P 
ae mm BCC 
tt £6 01 1480 INC P+1 
0869- 60 1760 .1 RTS 
$710. @onecseees oo Saree sees se 
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Modify S-C Macro For Overlay Assembly.....Bob Sander-Cederlof 


From time to time we have been asked about adding some features 
to the S-C Macro Assembler that would make it easy to assemble 


Overlay segments. We have finally done it. 


Some of you are developing programs that are so large that 
there is not room in the main 64K memory for everything at 
once. I have heard of one system that has over 200K bytes of 
machine language object code! Overlaying code segments is one 
method of making such a large program fit. A main program 
always resides in memory, and loads different sections of code 
when they are needed. These might be read from disk, from 
RAMdisk, or just copied from another section of extended 
memory. The main program calls program sections in one 
overlay, loads in another overlay and calls routines in it, and 
s0 on. The main program section also contains common 
subroutines that are used by more than one overlay. This is a 
rather standard technique on mainframe computers. 


The normal method for building overlay programs on larger 
computers involves assembling all the parts as separate 
relocatable object modules, and then building the overlay 
“tree“ of files with a program called a “Link Editor”. You can 
do something like this with the Apple Programmer's Workshop on 
the IIgs. However, if you are trying to use the S-C Macro 
Assembler (and we hope you are!) there is no Link Editor and no 
way Of generating relocatable object modules. The S-C 
Assembler does all its linking during assembly, and does not 
Make it easy to build overlays. Of course, we are about to 
change that within this very article. 


Since code in the main section calls subroutines in the 
overlays, we need a way of knowing addresses within the 
Overlays. Likewise the overlays need to Know the addresses of 
programs and data within the main section. If everything is 
assembled at the same time, all this cross linking can be done 
automatically. However, it requires making sure that there are 
no duplications of label names between overlays. The result 
can be huge assembly-time symbol tables that overflow the space 
available. By using the .INB directive (available in the 
ProDOS version of the S-C Macro Assembler) you can maximize the 
Space available for symbols, but it still can run out of space. 


If you are using Apple's APW on the IIgs you can do it because 
of the Link Editor. In fact there are Tools included in the 
System Loader for handling overlays. Of Course you are 
probably trying to write programs that will run on //e's or 
//c's, since that is still what most people own. And you are 
most likely not comfortable with APW and the System Loader and 
all the other IIgs tools yet. So what can you do? 


It is already possible to do it with the S-C Assembler, except 
that with such large programs the symbol table during assembly 
can get so large that you run out of memory. With the patching 
program I am about to describe you can use our assembler to 
build overlays, even with extremely large amounts of code that 
would normally overflow the space available for the symbol 
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Serial Pro’ 
The intelligent 
multifunction card from 
Applied Engineering. 


Serial Pro is a powerful multifunction card for the Apple Ile. 
lI+, Ics and compatible computers. Serial Pro combines a 
powerful serial port for interfacing to a printer, modem or other 
serial device, with a full function clock/ calendar. Serial Pro's serial 
port is compatible with virtually all letter quality and dot mawix 
printers, including Apple's Imagewriter and Imagewriter Il, and 
can communicate with the fastest external modems at baud rates 
from 50 to 19,200. 

Set up is easy, because unlike other cards, there are no switches 
to program serial parameters or disks to use. Serial Pro has a 
built-in setup screen that allows all parameters to be set And on- 
scteen help that makes it super-easy. An on-board battery stores 
your selections for over 20 years, but you can change them at 
any time. Serial Pro is the perfect upgrade for Super Serial card 
owners looking for more performance or a built-in clock 


Serial Port Features) e Fully Super Serial Card compatible but 
more versatile and easier to use e Compatible with printers 

e Compatible with modems e Prints graphics to printer (without 
software) in normal mode, 90° rotation, double size, side by side. 
and black/white inversion e Variable word length, number of 
stop bits and parity selection ¢ Cnstal conuolled circuits are 
used to provide ultra accurate baud rates. 


Clock Calendar Features e ProDos, DOS and AppleWorks 
compatible. Displays ime and date on the AppleWorks screen 
e Automatically time and date stamps AppleWorks files 20 
year auto recharging nickel-cadmium battery ¢ Realtime inter- 
rupts ¢@ Built-in on screen time and date settings (no software 
needed) ¢ Does not use phantom slots 

Serial Pro is perfect for Apple He, 1+, Gs or compatible 
owners in need of a serial port or clock/ calendar or both. But 
unlike other multifunction cards on the market, Serial Pro does 
not use phantom slots, so all the slots in your computer are 
useable. 

Serial Pro comes complete with manual, cable and instructions 
for connecting to all the leading printers and modems. 
Serial Pro $159 
Order Today! See your dealer or call Applied Engineering, 9 am. 
to 11 p.m. 7 days Or send check or money order to Applied 
Engineering, MasterCard, VISA and C.O.D. welcome. Texas 
residents add 54% sales tax. Add $10.00 outside U.S.A 


HG. APPLIED ENGINEERING” 
The Apple enbancement experts 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 
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table during assembly. However, the following patches do not 
provide a COMPLETE overlaying capability. For one thing, you 
will have to handle loading each overlay yourself when your 
program executes. For another, there is not capability for 
using symbolic reference from the main section into the overlay 
sections. For another, I have only shown here patches for the 
ProDOS version of the S-C Macro Assembler. A similar program 
would work with the DOS version, but the addresses for patching 
would be different. 


I do provide the ability for symbolic reference from overlays 
back to the main, which is the more important direction. For 
entry points within the overlay sections, you will need to use 
some sort of jump tables or other fixed address entry point 
method. Here is an outline of what I am talking about: 


Main: load overlay l 
call routines in overlay 1 thru JMP table 
load overlay 2 
call routines in overlay 2 thru JMP table 
et cetera 
end 


Common Subroutine A 
Common Subroutine B 


Common Subroutine Z 
Common Data 


Overlay n: Jump Table: JMP ENTRY1 
JMP ENTRY2 


JMP ENTRYN 


ENTRY]: do stuff, call main routines as 
necessary, end 
ENTRY2: et cetera 


One way Of assembling such a program now without any 
modifications to the S-C Assembler would be to simply use .IN 
er .INB to include the main section withing every overlay 
source file. When you are assembling such a program the main 
fection would be assembled over and over again, needlessly. 
“he new approach lets the main section be assembled once; its 
(bject code is written on a file and its symbol table is saved 
in memory; then each overlay is assembled, beginning with the 
symbol table of the main program. 


The general approach is to assemble the main section; mark the 
symbol table; assemble the first overlay; prune the symbol 
table back to the mark; assemble the next overlay; prune, 
assemble, and so on till the last overlay is assembled. To 
make it aS automatic aS possible, the entire assembly is 
controlled by an EXEC file. The EXEC file loads and executes a 
file named B.USR.ASM which creates the new overlay assembly 
Capability, loads the main source code or the assembly control 
file for the main section, assembles the main, and then 
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successive assembles the various overlays. 


The key, of course, is B.USR.ASM. This program, when loaded 
and executed, stores an address into the vector for the USR 
command into the S-C Macro Assembler. It also searches memory 
for a particular entry point inside the code which process the 
“ASM" command, and patches itself with that entry point. The 
USR command is then enabled. 


The USR command works in two ways, depending on whether it is 
the first use since loading and executing B.USR.ASM, or a 
subsequent use. The first time it saves the current address 
for the end of the assembler's symbol table. On subsequent 
uses it prunes back the assembler's symbol table to that saved 
address. In both cases, after diddling with the symbol table, 
it jumps into the ASM command just after the point at which the 
symbol table would normally be cleared. 


Perhaps it is best now to look at the listing of my program. 
The first section, called INSTALL.USR, is the code that is 
executed if you "BRUN B.USR.ASM” or “-B.USR.ASM". Lines 
1180-1340 search for the spot inside the ASM command code which 
we need to JMP to. The code at the beginning of the ASM 
command looks like this: 


STX $60 
STX SEE 
STX SEF 
STX $53 
STX $54 
JSR INIT.SYM.TABLE 
JSR ..- 


The place where we want to enter the ASM command is that second 
JSR. We still have to STX in those five locations, and the 
value in X needs to be zero. You can see the USR version of 
this at lines 2250-2340. My search loop uses the five STX 
lines here as a search key. When it finds the same ten bytes 
inside the assembler somewhere between $9000 and S92FF, it 
assumes it has found the ASM command code. By adding $000D it 
computes the address of that second JSR, and then plugs that 
address into the JMP instruction at line 2340. Lines 1350-1420 
do that computation and plugging. Lines 1430-1480 then install 
the USR address into the USR vector and return to the 
assembler. 


When you type or: EXEC the USR command, the assembler will jump 
to USR at line 1500. Lines 1510-1520 check a flag to see if 
this is the first time you did it or not. If it is the first 
time, lines 1540-1600 save the address of the end of the symbol 
table, and then line 1610 starts up the ASM command without 
clearing out the symbol table. This is how you would assemble 
the first overlay, after assembling the main section. 


On subsequent uses of USR, lines 1630-2230 will prune back the 
symbol table to the same state it was the first time, and start 
up the assembly with that symbol table. This “pruning back” is 
not easy. The structure of the symbol tables is a set of 28 
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Multiply memory — Add up to 


1 MEG with Z-RAM Ultra. \ | 


Multiply s Run and load 
Programs up to 30 times faster 


Multiply production = Printer —____ 
buffer lets sou keep working 

while the system prints 

AppleWorks files. 


.| 


é / 
\ 


Multiply value -. Get Pinpoint's 
a AppleWorks accessories with 
KAM cohancement software, a 


SHS value. for ony $79 if 
ordered with Z-RAM Ultra. 


Multiply efficiency Optional 
‘} —— bSCSI6 16 bit processor plugs in 
a casth with no other component 
changes 


—— Multiply applications = Run 
CPM programs with built-in 
oh Z-80B microprocessor. 


Ic multiplied. 


imagine multiplying your AppleWorks 
word processor capacity over threefold 
to 22,600 lines from its present 7,250. 

Multiplying your maximum number 
of records to 22,600 from the current 
6,350. And available desktop memory 
rockets to over 700K with all of 
AppleWorks loaded into RAM. 

You can do all of that and more with 
the Z-RAM Ultra expansion board for 
Apple Hc’s. 

Z-RAM Ultra completely loads pro- 
grams into RAM, then runs them up to 
30 times faster. And the included RAM 
disk is compatible with Applesoft, PRO- 
DOS, DOS 3.3, PASCAL and CP/M”. 

Z-RAM Ultra even expands the clip- 
board and autosegments large files so 
they can be saved on two or more 
disks. Nothing clse even comes close to 
enhancing AppleWorks like this! 

There's lots more. 

Memory and speed just begin the 
story. Z-RAM Ultra $ has a built-in 
Z-80B microprocessor so it can run 
CP/M programs. That's the largest body 
of software in existence and includes 
WordStar, dBase I, Turbo PASCAL, 
Microsoft BASIC and more. 
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With Ultra 2 & 3, there’s a PRO-DOS 
compatible, battery-backed up clock 
that displays time and date on 
AppleWorks screens and time and date 
stamps any PRO-DOS file. 


There's an AppleWorks printer buffer so 
you keep working while files are printed. 


With its patented technology and 
computer aided design, Z-RAM Ultra 
runs with less than half the power drain 
of other memory cards. 

Easy to install. 

It's easy to get all that performance. 
Z-RAM Ultra installs in just a few min- 
utes with a screwdriver — no jumper 
wires, no clips, no drive removal. 

A complete package. 

Z-RAM Ultra comes with simple, 
casy-to-follow instructions, RAM disk 
software, 7-80 operating system, CP/M 
manual, a five-vear “hassle-free” war- 
ranty, and all the AppleWorks enhance- 
ments we're famous for. 

See your dealer or call today. 

For more information or to order 
your Z-RAM Ultra, see your dealer or 
call 21-4-2-41-0000 between 9 am and 


I pm, 7 days. Or send check or money 


order to Applied Engineering. 
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Prices 
Z-RAM Ultra 3 (with memory, clock 
and CP/M) 
265K — $329.00 512K — $379.00 
1 MEG — $459.00 


org Ultra 2 (with memory and 
) 

256K — $269.00 512K — $319.00 
1 MEG — $399.00 


Z-RAM Ultra 1 (Memory only — ex- 
pandable to 512K) 


256K — $199.00 512K — $249.00 


software 

(List price, $118.00) 

16-bit 65€816 Upgrade 

Z-80C Card to run CP/M software (no 


MasterCard, Visa and C.0.D. welcome. 
Texas residents add 614% sales tax. Add 
$10.00 outside U.S.A. 


GF Vo a regtered trademark of Digital Research tn 


Fras wa Applied Engineering 


The Apple enbancement experts. 


P.O. Box 798, Carrollton, TX 75006 
(21-4) 2-41-0000. 


linked chains. There is one chain for each letter of the 
alphabet, and a symbol is placed in a chain based on the first 
letter of its name. There are two more chains, one used for 
Macro definitions and another for target file information. 
Within each chain, symbol entries are kept in alphabetical 
Order. This means that when we assemble the first overlay, 
some new symbols will be linked into existing chains in 
arbitrary positions. The “pruning back" operations cannot 
simply store the original “end of symbol table" address; it 
must also remove any and all symbol entries from each chain 
which are beyond that address. 


Lines 1630-2140 do just that. There are 28 pointers kept at 
$0130-$0167 which point to the first entry in each of the 28 
chains. Then the first two bytes of each symbol entry contain 
& pointer to the next entry in alphabetical order. The last 
symbol entry in a chain contains 0000 in these two bytes. If 
there are no symbols in a particular chain, itsS pointer in the 
$0130 area will be 0000. This code loops from 0 to 27, 
eliminating all entries beyond the marked end of table address 
for each of the 28 chains. 


Finally, lines 2190-2230 restore the saved end of table 
address, and we fall into the code to enter the assembler 
without clearing the symbol table. 


Using my program with an EXEC file makes all this easy. Here 
is an example of such an EXEC file: 


-B.USR.ASM 
LOAD MAIN 

ASM 

LOAD OVERLAY .1 
USR 

LOAD OVERLAY. 2 
USR 

LOAD OVERLAY .3 
USR 


Fach of the files loaded above could either be complete 
gections, or merely small assembly control files with a lot of 
-IN or .INB directives specifying source files to include. I 
recommend the latter, using the .INB directive. For example, 
MAIN might look like this: 


1000 -TI 55,TITLE OF MAIN PROGRAM 
1010 -INB MAIN.EQUATES 

1020 ~INB MAIN. PART1 

1030 ~INB MAIN. PART2 

1040 -INB MAIN.LAST. PART 


An OVERLAY.n file would be similar, but would name the 
particular files involved in that overlay. Since each overlay 
is separately assembled, there may be identical symbol names in 
different overlays with no conflict. Since the MAIN symbol 
table is present during the assembly of each overlay, the code 
in the overlays may freely reference any symbol names in the 
MAIN section. 
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0340- GE C9 03 
- 8D CA 03 


CON AN EWA) = Ow DOAN WW A = OW OA HUI SW = Ovo 


ak oh cd ceth ed ead ch ch ed ce eh eh et etd ed eh ee ah a ed ct coc et ond ae etd ed th cd ce cd ch ch ch we ee ch ce dh eh ced wc eed ch ee ee cee eh ct ed wed et cath cd td enh ce wee cath ced eh ee eh ed cd wad ced ed ce et eh wed ed ed ed od od 


SNS NS AD QHANHAHAAAAnAMNIMAIMNSVNUSIUIUIU SE Pr rr ree 


90 

O34A- 8D CB 03 1600 
O34D- AC BA 03 10 
20 

Ro 

0 

20 

0 

fo 

0350- A2 00 4 
0352- 8A 30 
0353- OA 10 
0354- 69 30 20 
0356- 85 53 30 
0355—- AQ 01 0 
035A- 85 50 
60 
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SAVE S 
 ] 


~USR. ASM 


a OE OSE SS SSFP FS SSCSV SS SF SF SF SF SVT SFM FO SQ Sees 


oecen -EQ i 254 Page number, starts at 0000 


EOT : 
ERROR.CNT - EQ 


Pass number, starts at 00 
CC,CD Address of En 
EE,EF Error count, starts at 0000 


HASH . TBL - EQ $8480 eee $0167 (28 pointers) 


8006 ddress USR command jumps to 


INST ALL 


3 
#---Ins 


#---Ins 


SUBSE QU 
aad 
eee 
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EE , EF Use ERROR.CNT temporarily 
EE , EF Use ERROR.CNT temporarily 
-USR 

A frouee FIND ENTRY INTO "ASM" COMMAND 


~EQ fie er Use PAGE.NUM temporaril 


INC PASM 
INC PASM+1 


BNE .1 
BRK TRAP IF KEY NOT FOUND 


BPL .2 

tall ASM link address----- 
CLC 

LDA PASM 

ADC #$0D 

STA JMPASM+1 

LDA PASM+1 

ADC #0 

STA JMPASM+2 

oo USR NOW] n nnn nen ee 


A #USR 

STA USER .HOOK+1 
A /USR 

STA USER .HOOK+2 


BIT FIRST. TIME .FLAG 
BMI SUBSEQUENT. TIME 


Set Flag Negative for Subsequent 
ROR FIRST. TIME.FLAG 

LDA EOT Save Address of End of 

STA PNTR SYMBOL TABLE 

LDA EOT+1 


PNTR+1 
JMP JUMP.INTO. ASSEMBLER 
ENT. TIME 
Rebuild pointers by starting at beginning of 
each chain in HASH TABLE and traveling to end 
agh chain, lopping off any symbols beyond 
#0 


of e 
PNTR 
LDX FOR X = 0 TO 27 


ASL INDEX ® 2, CLC 
ADC #HASH.TBL 
A CHAIN 
LDA /HASH.TBL 
STA CHAIN+1 


d of Symbol Table 


Ram Factor 


Boot any IF, Ie, or lcs and be up and running your 
Javorite software in less than 1 second. 


Naw anyone with an Apple I+, Franklin, Laser 128, Apple Ile or Ilcs preferring to use 
slots 1 through 7 can now enjoy the speed and performance that they've been waiting for. 
With RamFactor, you'll be able to instandy add another 256K, 512K, or a full 1 MEG on 
the main board and an expansion connector can address an additional 16 MEG of 
memory for possible future expansion. Since virtually all software is automatically 
compatible with RamFactor, you'll immediately be able to load programs into RamFactor 
for instantaneous access to information. You'll also be able to store more data for larger 
word processing documents, bigger data bases, and expanded spreadsheets. And with the 
battery back-up option, you can switch on your Apple and your favorite software will 


be up and running in less than 1 second! 


Very Compatible 

All the leading software is already com- 
patible with RamFactor. Programs like Apple- 
Works, Pinpoint, BPI, Managing Your Money, 
Dollars and Sense, SuperCalc 3A, PFS, Mouse- 
Write, MouseDesk, MouseCalc, Sensible 
Speller, Applewriter Ile, Business Works, 
ReportWorks, Catalyst 3.0 and more. And 
RamFactor is fully ProDos, DOS 3.3, Pascal 13 
and CP/M compatible. In fact, no other slot 
1-7 memory card is more compatible with 
commercial software. 


AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but that’s the 
end of their story. But RamFactor is the only 
slot 1-7 card that increases AppleWorks 
intemal memory limits, increasing the maxi- 
mum number of records in the database and 
lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load all of AppleWorks into 
RAM dramatically increasing speed and 
eliminating the time required to access the 
program disk, it will even display the time 
and date on the AppleWorks screen with 
any ProDos clock RamFactor will automati- 
cally segment large files so they can be 
saved on 5%", 342”, and hard disks. All this 
performance is available on the Apple II+, 


The “Instant On” Apple. 


when you tum your computer off And 


Ile, Franklin, or Laser 128 when used with an 
80 column display. RamFactor, no other 
standard slot card comes dose to enhancing 
AppleWorks so much 


With the RamCharger 
battery backup op- 
uon, RamFactor 
will retain pro- 
grams and data 

during power 
failures or even 


| RlamCHARGER | 


APPLIED 
ENGINEERING 


because RamFactor plugs into slots 1-7, it's 
the only memory card that can cold boot 

an Apple without using slow floppy or hard 
disks. An available “Y” cable allows one 
RamCharger to power two RamFactors. 


Powerful Program Switcher 
With RamFactor, you can organize 
memory into multiple work areas and switch 
between them. Each work area can contain 
different programs and even different operat- 
program to another or even switch from 
AppleWorks to DOS 3.3 to CP/M to Pascal to 
ProDos in under a second. And with our 
battery back-up option, you can have 
permanent storage for up to 20 years. 


Features: 

e 250K to 1 MEG on main board Expansion 
connector for possible further expansion to 
16 MEG. 

e Fully Apple II Memory Expansion 
compatible 

e Compatible with Apple He, I+, Ilcs, 
Franklin and Laser 128 

e Battery back-up option allows vou to tum 
on your Apple and run your favorite 
programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 
3.3, Pascal, and standard CP/M 

e Buik-in RamDrive™ software (a tue RAM 
disk not disk caching) 

e Systems are directh’ bootable from Ram- 
Factor if desired 


e Allows Apple II+ and Ie to run your 
AppleWorks without buying any 


e Accelerates AppleWorks 

e Displays time and date on the AppleWorks 
screen with any ProDos clock 

e Fits any I/O slot except slot 3 

e Fully socketed and user upgradeable 

e Much, much more 


RamFaector with 256K 
RamFactor with 512K 
RemFactor with 1 MEG 
RaemFactor with 2-16 MEG 
RamCharger beckup option 
“Y” cable 


$24 
(Allows one RareCharger to power two RamFactore.) 


Order RamFactor today... with 15 day . 
money back guarantee and our “no hassle” 
five year warranty. See your dealer or call 
(214) 241-6060, 9 am two 11 pm, 7 days, or 
send check or money order to Applied 
Engineering, MasterCard, Visa and C.O.D. 
wekome. Texas residents add 6% sales tax 
Add $10.00 if outside USA 


TC. Applied Engineering” 
The Apple enbancement experts. 
(214) 241-6060 


P.O. Box 798, Carroliton, TX 75006 
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035C=- AO 00 i ae LDY #0 Get address of next symbol 
035E- B1 53 1780 LDA (CHAIN),Y in this chain 
0360=- 85 EE 1790 STA FWD 
0 62- a CA 03 1800 CMP PNTR See if beyond truncation point 
0 -C 1810 INY 
0 - Bl BF 1820 LDA (CHAIN) ,Y 
036A- 85 EF 1840 STA FWD+1 
036C=- ED CB 03 1990 SBC PNTR+1 
O36F- BO OA 1860 BCS .3 ~«-beyond truncation int 
0371- A5 EE 1870 LDA FWD Step forward to next link 
0373- 85 53 1880 STA CHAIN 
0375- A5 EF eae LDA FWD+1 
0 f- 8 4 3 0 STA CHAIN+1 
0 es 9 1 1 10 BCC e ~«e ALWAYS 
1350 #---Found link beyond truncation point--- 
C37B=- AO 00 1 30 3 LDY fp Look forward through chain 
037D- B1 EE 1940 LDA (FWD) ,Y until find one below 
C37F- 8D CC 03 1950 STA TCHAIN the truncation point. 
0C382- CD CA 03 1960 CMP PNTR 
0385- C8 1370 INY 
0386- B1 EE 1980 LDA (FWD),Y 
C388- 8D CD 03 1990 STA TCHAIN+1 
C38B- ED CB 03 2000 SBC PNTR+1 
038E- 90 OC 2010 BCC .4 ...below truncation point 
0390- AD CC 03 2020 LDA TCHAIN Step forward to next link 
0393- 85 EE 2030 STA FWD in this chain 
Q 3. AD CD 03 2040 LDA TCHAIN+1 
0 - 85 EF 2050 STA FWD+1 
039A—- BO DF 2060 BCS .3 oe ALWAYS 
2070 #---Patch out truncated links of chain--- 
039C- AO 00 2080 .4 LDY #0 
O39E- AD CC 03 2090 LDA rn 
O3A1- 24 53 2100 STA (CHAIN) ,Y 
O3A3- C 2110 INY 
O3A4=- AD CD 03 2120 LDA TCHAIN+1 
O3A7= 91 53 2130. STA (CHAIN),Y 
O3AB- E8 2160 .5 INX NEXT X (0...27) 
O3AC- EO 1C 2170 CPX #28 
O3AE- 90 A2 2180 


03B0- AD CA 03 2200 
03B3- 85 CC 2210 STA EO 
O3B5- AD CB 03 2220 LDA PNTR+1 
O3B8- 85 CD ae P STA EOT+1 
2250 JUMP. INTO .ASSEMBLER 
O3BA- A2 00 22600 LDX #0 
2270 KEY 
OsBEA 86 60 2280 STX PASS.NUM 
O3BE- 86 EE 2290 STX ERROR.CNT 
03CO- 86 EF 2300 STX ERROR.CNT+1 
03C2= 86 5 2310 STX PAGE.NUM 
O3CH- 86 5 2320 STX PAGE. NUM+1 
2330 JMPASM 
03C6- 4C 00 00 3360 2 JMP #-# ### ADDRESS FILLED IN BY PROGRAM ### 
03C9- 00 2360 FIRST.TIME.FLAG .HS 00 
O3CA- 00 00 2 he NTR . . 
03CC- 00 00 33 TCHAIN .HS 00.00 
2390 8 nnn nnn nnn nnn nn nnn nnn nnnn= 
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